手势控件
路径：控件库 > 按钮 > 其他
手势控件是一个热键，通过其可生成手势事件。
| 手势事件 | 说明 |
|---|---|
|
OnSwipeLeft OnSwipeRight |
检测到滑动手势时会释放事件 |
|
OnPinchOpen OnPinchClose |
检测到缩放手势时会释放事件 |
|
顺时针旋转 逆时针旋转 |
检测到旋转手势时会释放事件 |
|
OnPan OnPinch OnRotate |
在手势期间释放的一系列事件。 尽管开发人员可以通过 JavaScript 代码管理其喜欢的手势事件，但是仅 JavaScript 可用于服务这些事件。 警告：仅多点触摸 HMI 设备可生成 OnPinch 和 OnRotate 事件 |
OnPan
boolean onGesturePan(me, eventInfo)
本事件会在按下该区域内一点时并检测到线性移动时发生。
| 参数 | 说明 |
|---|---|
| me | 启动事件的对象。 |
| eventInfo |
ID = 手势 ID；用于识别不同手势。 running = 除用于通知手势完成的最后事件外均为 true。 dx = 从初始触摸位置以屏幕像素单位 X 轴移动总和。 dy = 从初始触摸位置以屏幕像素单位 Y 轴移动总和。 |
OnPinch
boolean onGesturePinch(me, eventInfo)
本事件会在按下该区域内两点时并检测到线性移动时发生。
| 参数 | 说明 |
|---|---|
| me | 对象启动事件 |
| eventInfo |
ID = 手势 ID；用于识别不同手势。 running = 除用于通知手势完成的最后事件外均为 true。 dx = 从初始触摸位置以屏幕像素单位 X 轴移动总和。它代表手指之间的距离变化。正值代表正在增大的距离；负值代表正在减少的距离。该量可用于控制缩放值。 dy = 从初始触摸位置以屏幕像素单位 Y 轴移动总和（见 dx）。 |
OnRotate
boolean onGestureRotate(me, eventInfo)
本事件会在按下该区域内两点时并检测到旋转移动时发生。
| 参数 | 说明 |
|---|---|
| me | 对象启动事件 |
| eventInfo |
ID = 手势 ID；用于识别不同手势。 running = 除用于通知手势完成的最后事件外均为 true。 drot = 自上一个事件起已添加多少度 (0/360)。 trot = 整个移动的总度数 (0/360)。 整数表示顺时针旋转，负数表示逆时针旋转。 |
手势事件密码
要使用手势对象中覆盖的控件（例如，按钮或滑块），必须按住该控件 200 mSec 以便将该控件移至底层对象。可通过高级属性视图中可用的“手势密码延迟”参数修改将命令发送到底层对象所需等待的时间。
| 参数 | 说明 | ||||
|---|---|---|---|---|---|
| 手势密码已启用 |
启用在可配置延迟后将手势事件传递给底层控件的可能性。用户必须按住手指，然后执行手势。 default = 使用项目属性中定义的值。请参阅"项目" true = 手势密码已启用 false = 手势密码已停用 |
||||
| 手势通过延迟（毫秒） |
将命令发送到底层对象所需等待的时间
|
使用与 JavaScript 相关联的手势事件的示例
以下是一些使用与 JavaScript 代码相关联的手势事件来识别手势和编程请求动作的示例
滑动手势
如何识别“滑动”手势，以更换应用页面。
- 将手势控件放入页面中
- 配置 OnPan 动作以触发 JavaScript 函数
- 编写可识别和管理滑动手势的 JavaScript 代码
.png)
缩放手势
如何识别“缩放”手势，以调整图片大小。
- 将手势控件放入图片上方的页面中
- 配置 OnPinch 动作以触发 JavaScript 函数
- 编写可识别和管理缩放手势的 JavaScript 代码
.png)
平移手势
如何识别“平移”手势，以移动图片。
- 将手势控件放入图片上方的页面中
- 配置 OnPan 动作以触发 JavaScript 函数
- 编写可识别和管理平移手势的 JavaScript 代码
.png)